home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaDemoCD1.iso / DEMOS / DEVIOUSDESIGN-bpIssue37.dms / in.adf / ­­>UTILITIES<­­ / Debug Console Warez.lha / FNL-DEBUG.doc < prev    next >
Encoding:
Text File  |  1980-11-15  |  2.8 KB  |  91 lines
  1. .______/\     FINALISTS   ./\      /°\
  2. |.     \/___ ._./C \  ._. |_/_____/ ° \_____
  3. || ____/|   \| |  O \ | | | | __¸/ \/\ \__,/
  4. ¦: __/| ¦   ° ¸|   N \| | | ¦ \__\__.__/\__
  5. |· |  | |   :  |    S \ | | |, _ \  |  , _ \
  6. |  |  | |   ¡  |  :  O \l_| | \/ /  |   \/ /
  7. `--'  '-'---'--' / \  L \__}'\__/   |  \__/
  8.               p^r^e^s^e^n^t^s
  9.  (!AMIGa) DEBUG CONSOLE WAREZ V2.F (aMIGA!)
  10.               p^r^e^s^e^n^t^s
  11. [version2.0f/console utility debugger/amiga]
  12.            !hAVE pUN wITH tHIS!
  13.  
  14.  
  15.             Debug Console 2.0F
  16.  
  17.            (c) 1995 FREEUTIL
  18.  
  19. =============================================
  20.  
  21.  
  22. Preface
  23. =======
  24.  
  25.    DeBUGG 2.0F
  26.  
  27. Introduction
  28. ============
  29.  
  30.    Many debugging utilities send their output to serial port using simple
  31. communication mechanism embedded in the exec.library -- the RawPutChar
  32. function.This simple utility patches that function, opens a window screen
  33. and redirectswhole debugging output to this window.
  34.  
  35.    Warning:  DeBUGG uses simple line buffering mechanism to increase speed
  36. whichcauses incomplete lines not to be displayed before a newline
  37. character (or anyother character with code less than 32) is received.
  38. NULs are not stored in thebuffer, but they cause flushing, too (you can
  39. use NUL to empty the buffer).
  40.  
  41.    If  you're  debugging  a resident module, you can install
  42. DeBUGG as a residentmodule  by the AddModule utility (also included in
  43. this archive).  In this case,priority  of  DeBUGG module is set to 4 by
  44. default, therefore it gets initialized directly after the console device.
  45.  
  46.    DeBUGG is NOT pure and cannot be made resident (sorry, but if it were pure, it
  47. would be much larger and slower).  The resident module can be used multiple
  48. times, but it's self-modifying and some other tools allowing module installation
  49. could inform you about non-mathing checksums -- these warnings are usually false
  50. alarms and can be ignored.
  51.  
  52.  
  53. Requirements
  54. ============
  55.  
  56.    - Kickstart 2.04 or higher
  57.  
  58.    - ss.library 5.0 or higher (included in this archive)
  59.  
  60.    - 68000 or higher
  61.  
  62.  
  63. Command-line invocation
  64. =======================
  65.  
  66.    If started from CLI (that means not as a resident module), additional
  67. parameters can be specified according to this template:
  68.  
  69.    LEFT/N,TOP/N,WIDTH/N,HEIGHT/N,TITLE,SCREEN
  70.  
  71.    First four parameters define window position, the next one allows to specify
  72. custom window title, the last one forces DeBUGG to use given public screen for
  73. its output.
  74.  
  75.  
  76. Other controls
  77. ==============
  78.  
  79.    (1) - Program termination - by clicking the close gadget of DeCon window
  80. or by sending a CTRL-C signal to it.
  81.  
  82.    (2) - Saving console buffer to T:Debug - press CTRL-W (OK will appear and
  83. last 16K of debug output will be saved).
  84.  
  85.    (3) - Stopping/restarting of console output - press CTRL-S to stop console
  86. output, use CTRL-Q to restart it.
  87.  
  88.    (4) - Clearing of console window and all information in the buffer - CTRL-L.
  89.  
  90.  
  91.